home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / wp / csifix2.zip / CSIFIX.DOC next >
Text File  |  1994-07-08  |  12KB  |  329 lines
  1.                                     CSIFIX2
  2.               A reformatter for IBM PC files that create problems
  3.                when sent to a Composition Systems, Inc. system.
  4.                                 By Peter Zicari
  5.                               Ver 2.0, July 1994
  6.                                        
  7. WHAT IT DOES
  8.     Some newspapers' CSI front-end systems have trouble with plain DOS text.
  9.     They strip out the normal DOS line ending (CR/LF, #13 and #10 in ASCII),
  10.     causing lines to run together.  They don't recognize paragraphs.  Some
  11.     CSI systems also convert symbols like "=" to line ending codes, and
  12.     unavoidably treat quote marks as open- quotes only, although the
  13.     typesetter will need to make a distinction between open quotes and close
  14.     quotes.  Some recognize "#" as the beginning of a non-printing note.
  15.     Different systems recognize different codes as paragraph endings, as
  16.     well.
  17.     
  18.     CSIFIX converts DOS text files saved with line endings to continuous
  19.     lines broken only at paragraphs.  A correct paragraph marker is inserted.
  20.      End-quote marks are fixed, and "=" and "#" are removed.  An optional
  21.     heading to add desk, slug and initials is included, which take care of
  22.     non-keyboard characters some systems require.
  23.     
  24.     The original is copied, not altered.
  25.     
  26.     Although CSIFIX is intended for use with DOS text, this version allows
  27.     you to type  $START$ and $END$ at beginning and end of text to eliminate
  28.     data some word processors add at top and bottom of files.
  29.     
  30.     
  31. INSTRUCTIONS FOR CSIFIX
  32.     If this is your first time using CSIFIX and you are going to use it on a
  33.     hard drive, please follow the INSTALLATION INSTRUCTIONS before
  34.     proceeding.
  35.     
  36.     1. Write as usual. Spell-check your copy; save it as ASCII text as you do
  37.     now.
  38.        To make a paragraph, use either 3 or more spaces or a blank line.
  39.     
  40.     It is not necessary to type "///" or an alt-number key combination at the
  41.     ends of paragraphs, or at the end of the story.
  42.     
  43.     2. Quit your word processor. (Don't forget to save the document first).
  44.     
  45.     If you are not using CSIFIX on a hard drive, skip to ALTERNATE
  46.     INSTRUCTIONS below.
  47.     
  48.     At a C:> prompt . . .
  49.     
  50.     3. Type CSIFIX and the name of the file you plan to transmit.
  51.        Example:   csifix mystory
  52.     
  53.        CSIFIX will reply:
  54.          Reading mystory
  55.          Checking mystory.OUT
  56.          Writing mystory.OUT
  57.     
  58.     
  59.     Then ...
  60.     Do you want to change the current set-up codes for your
  61.     output file? Press Y or y.
  62.     
  63.     4. Press the Y key for "yes."  See the instructions below on changing the
  64.        settings.
  65.     
  66.     then...
  67.     
  68.       Please enter your CSI desk, filename, and initials.
  69.       Desk and slug are limited to six characters each.
  70.       Separate them with commas. You don't need to type
  71.       brackets.
  72.       Example:  DESK11,EXAMPL,XXX
  73.     
  74.     
  75.     5. Type the desk, slug, and your initials.  If you have already typed
  76.     the slug in the story, you can skip this step by pressing enter alone.
  77.     
  78.     
  79.     CSIFIX will reply
  80.               Done!
  81.     
  82.              Press enter to go on.
  83.     
  84.     6. Press Enter. You're done.
  85.     
  86.     7. When you send the file, transmit filename.OUT rather than the
  87.     original.
  88.     
  89.     
  90. ALTERNATE INSTRUCTIONS
  91.     3. Put the CSIFIX disk in the A: drive.
  92.     
  93.     At an A:> prompt . . .
  94.     4.Type CSIFIX
  95.       Press Enter.
  96.       CSIFIX will reply:
  97.     
  98.        Please enter Input file
  99.        Press Enter to choose from list; to quit, press Esc.
  100.     
  101.     5. Take the CSIFIX disk out of the A: drive and insert the disk with your
  102.     file.
  103.     
  104.     6. Type the filename you want.  (Note: The file doesn't have to be in the
  105.     same drive. If it is on another one, specify which drive and/or directory
  106.     is is on.  The output file will be put in the same place unless you
  107.     specify otherwise.
  108.     
  109.        A:>myfile
  110.            or
  111.        A:>b:myfile
  112.            or
  113.        A:>c:\stories\myfile
  114.     
  115.     CSIFIX will reply:
  116.     Please enter Output file
  117.     Press enter to write to A:\filename.OUT. To quit, press
  118.     Esc.
  119.     
  120.     7. Press Enter.
  121.     
  122.     CSIFIX will reply:
  123.     
  124.     
  125.     Do you want to change the current set-up codes for your
  126.     output file? Press Y or y.
  127.     
  128.     
  129.     8. Press the Y key for "yes."  See the instructions below on changing the
  130.     settings.
  131.     
  132.     then...
  133.     
  134.     Please enter your CSI desk, filename, and initials.
  135.     Desk and slug are limited to six characters.
  136.      Separate them with commas. You don't need to type
  137.      brackets.
  138.      Example:  DESK11,EXAMPL,XXX
  139.     
  140.     9. Type the desk, slug, and your initials.  If you have already typed
  141.     the slug in the story, you can skip this step by
  142.     pressing enter alone.
  143.     
  144.     CSIFIX will reply:
  145.             Done!
  146.             Press enter to go on.
  147.     
  148.     Press Enter.
  149.     
  150.     10. When you transmit the file send myfile.OUT (or whatever the filename
  151.     is,
  152.         plus OUT) rather than the original.
  153.     
  154.     
  155.     
  156. VARIATIONS & ERROR MESSAGES
  157.  
  158.     A file directory
  159.     
  160.     Press Enter on the blank line of the first prompt to see a directory of
  161.     files in the default drive/directory. Use the cursor keys to move the
  162.     selector bar up and down and pick a filename from the box.
  163.     
  164.     To see more of the directory, use PageUp and PageDown.
  165.     To see the files in a different order or another list of files,
  166.     press F2 and follow instructions.
  167.     
  168.     (You may find that when you enter a new directory instruction, the
  169.     directory goes blank. Press PageUp a couple of times to find the
  170.     shorter directory.)
  171.     
  172.     Alternate output files
  173.        To send the output of CSIFIX to some file other than Filename.OUT, you
  174.     can
  175.        either . . .
  176.     
  177.     Type CSIFIX filename1 filename2 on the command line
  178.     
  179.     or
  180.     
  181.     Enter the new name after Please enter Output file.
  182.     
  183.     This is how you would put the output file on the b: disk, for example.
  184.     a:\>CSIFIX filename1 b:filename2
  185.     
  186.     
  187.     A safety feature
  188.     
  189.     If the filename you use is already on the disk, CSIFIX will report:
  190.     Filename1.OUT already exists. Press Y or y to rewrite it.
  191.     
  192.     Do what it says.  If you don't want to overwrite Filename1.OUT, press n
  193.     and enter a new filename at the prompt.
  194.     
  195.     You should be able to quit the program at any point by pressing Esc
  196.     several times.
  197.     
  198.     Some otherwise readable files write junk at their tops and bottoms. To
  199.     remove it, type $START$ at the top and/or $END$ at the bottom of the text
  200.     you want to save.
  201.     
  202. CHANGING THE DOCUMENT SET-UP
  203.  
  204.     CSIFIX allows you to customize several basic settings for the newspaper
  205.     you're trying to transmit to.  Once you have set them up and saved them,
  206.     you should not need to set them again.
  207.     
  208.     1. At the "Type Y or y" box mentioned above, type y.
  209.     
  210.     2. This box appears:
  211.     
  212.     
  213.       These are the current settings for
  214.       setup codes for your transmission.
  215.     
  216.       A. Size of indent in old copy:   3
  217.       B. Paragraph marker in new copy:
  218.     
  219.       C. Marker at start of CSI heading: [
  220.       D. Marker at end of CSI heading: ]
  221.       E. Marker at end of text:
  222.     
  223.       F. Save any changes on disk.
  224.       Q. Quit this menu & resume program.
  225.     
  226.     
  227.     
  228.     3. Select a variable to change either by moving the cursor up and down,
  229.     then pressing enter, or by typing a letter.
  230.     
  231.     -- A. is the number of spaces in a paragraph indent in the original.  If
  232.     you  write "block style", using a blank line between paragraphs, ignore
  233.     this one.
  234.     -- B. is the character the CSI system will need to see at the beginnings
  235.     of paragraphs.  Get this and the remaining four codes from the paper's
  236.     systems manager. If it is a non-keyboard character, type # and its ASCII
  237.     code in the entry box.  If you type more than one character, DO NOT enter
  238.     spaces between them.  Usually, you'll type the codes for carriage return
  239.     & line feed, too.
  240.     
  241.          They are #13#10.  A common setting might then be: #13#10#9, or
  242.     Carriage
  243.          return-line feed-tab.
  244.     
  245.     Note: CR/LF appear as a blank line under the "paragraph marker" line on
  246.     the screen.
  247.     
  248.     -- C. goes at the top of the file. You may enter up to 3 characters.
  249.     -- D. goes at the end of the heading.
  250.     -- E. goes at the end of the text.
  251.     
  252.     4. Enter the appropriate information in the box that appears next.  Each
  253.     box is different, but here is an example:
  254.     
  255.           Enter up to 3 characters for the paragraph
  256.           marker. Don't separate them with spaces of
  257.           commas. Enter non-letter characters by
  258.           typing # and the ASCII code of the desired
  259.           character.
  260.     
  261.          Non-keyboard codes are not likely to be needed for the CSI header,
  262.     but you
  263.          may need them for paragraphs and the start-of-file or end-of-file
  264.     markers.
  265.     
  266.     5. If you usually transmit to only one CSI system, save your entries by
  267.     selecting F. The only filename you should enter is
  268.                              CSIFIX.INI
  269.     which appears in the data-entry box.  However, you may want to put the
  270.     data in another directory, and you can do that by typing it in at this
  271.     point.  You should put CSIFIX.INI in a directory in your system's PATH,
  272.     preferably the same one CSIFIX itself is in.
  273.     
  274.     6. Quit by selecting or typing Q.  Any changes you make will remain in
  275.     effect as long as the program is running, even if you don't save them on
  276.     disk.
  277.     
  278.     
  279. INSTALLATION INSTRUCTIONS
  280.     Before you use CSIFIX, install it somewhere convenient on your hard
  281.     drive.
  282.     
  283.     1. Get a DOS prompt:      C:\
  284.     2. Type this command:     Path
  285.     3. Press enter.
  286.     A list of directories will appear that looks something like this:
  287.                       PATH=C:\;C:\DOS;C:\WINDOWS;C:\WP51\LEARN
  288.                                           
  289.     Every hard drive is different, so yours will be unique. Individual
  290.     directory names appear between semicolons.  Choose a directory to keep
  291.     CSIFIX in.
  292.     
  293.     C:\ or C:\DOS are good choices, if they're on the list.
  294.     
  295.     
  296.     4. Put the CSIFIX disk in your A: drive.
  297.     
  298.     5. Type this command:    Copy a:CSIFIX.*  {enter the directory you chose
  299.     here}
  300.                            Example:Copy a:CSIFIX.* c:\dos
  301.     6. Press enter.
  302.     
  303.     7. Take out the CSIFIX disk. You're done with it.
  304.     
  305.     8. Set up your default codes the first time you use the program by typing
  306.        Y or y when you are prompted to after entering filenames.  You will
  307.     need to
  308.        get the information from the newspaper's systems manager.  Save the
  309.      settings when you're finished by selecting option F.  CSIFIX will ask
  310.      for a filename.  Only CSIFIX.INI will be read, but you can use this step
  311.      to put the file in another directory, preferably one in your system's
  312.     path.
  313.      Ideally, you should put the defaults in the same directory as CSIFIX
  314.     itself.
  315.     
  316. DISCLAIMER AND COPYRIGHT NOTICE:
  317.  
  318.     CSIFIX is shareware, and all rights are hereby reserved.  You may copy
  319.     this program and accompanying documentation freely, as long as there is
  320.     no charge exceeding the cost of copying and media. I accept no
  321.     responsibility for problems arising from the use of CSIFIX, but if one
  322.     does arise, you may contact me via Internet at PETERZICARI@PCOHIO.COM or
  323.     on Compuserve at 71760,2575.
  324.     
  325.     Peter Zicari
  326.     2601 Idlewood Rd.
  327.     Cleveland Heights, OH 44118
  328.     
  329.